Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Constants

Other Call Appearance Feature Flags

The call appearance structure contains, in the otherFeatures field, a set of bit flags indicating the relationship between certain additional features and that particular call. A given feature can be subscribed, available, or active.

To specify the features of a given call appearance, the Telephone Manager defines the TELCAFeatureFlags (page 4-15) and the TELCAOtherFeatures data types. The TELCAOtherFeatures data type is defined as follows:

typedef unsigned long      TELCAOtherFeatures;

All unused bits in the featureFlags field are reserved.

enum {
   callbackSub             = 1L << 0,
   callbackAvail           = 1L << 1,
   callbackActive          = 1L << 2,
   callbackClearSub        = 1L << 3,
   callbackNowSub          = 1L << 4,
   callbackNowAvail        = 1L << 5,
   callbackBusy            = 1L << 6,
   callbackNoAnswer        = 1L << 7,
   callbackReturnsRef      = 1L << 8,
   parkSub                 = 1L << 9,
   parkAvail               = 1L << 10,
   parkActive              = 1L << 11,
   parkRetrieveSub         = 1L << 12,
   parkRetrieveWithID      = 1L << 13,
   parkWithReturnedID      = 1L << 14,
   parkWithGivenID         = 1L << 18,
   rejectable              = 1L << 15,
   deflectable             = 1L << 16,
   acceptable              = 1L << 17,
   voiceDetected           = 1L << 19,
   callAnswdTSRings        = 1L << 20,
   progressHasDuration     = 1L << 21
};

Constant descriptions

callbackSub

If this bit is set, the Callback feature is subscribed.

callbackAvail

If this bit is set, the Callback feature is available.

callbackActive

If this bit is set, the Callback feature is active.

callbackClearSub

If this bit is set, the Callback Clear feature is subscribed.

callbackNowSub

If this bit is set, the Callback Now feature is subscribed.

callbackNowAvail

If this bit is set, the Callback Now feature is available.

callbackBusy

If this bit is set, you can request a callback notification if the destination number is busy.

callbackNoAnswer

If this bit is set, when the remote party does not answer, you can request that the remote party call you back.

callbackReturnsRef

If this bit is set, the Callback feature uses a reference number to identify a callback request. If set, then the TELCallbackSet function (page 4-42) provides the reference number, and you need to pass it to TELCallbackNow (page 4-43) and TELCallbackClear (page 4-44).

parkSub

If this bit is set, the Call Park feature is subscribed.

parkAvail

If this bit is set, the Call Park feature is available.

parkActive

If this bit is set, the Call Park feature is active.

parkRetrieveSub

If this bit is set, the Call Park Retrieve feature is subscribed.

parkRetrieveWithID

If this bit is set, the Call Park Retrieve feature requires an ID assigned by the telephone system. The TELParkCall function (page 4-45) returns the ID; you pass it to the TELRetrieveParkedCall function (page 4-46) to retrieve the call.

parkWithReturnedID

Reserved.

parkWithGivenID

If this bit is set, the Call Park Retrieve feature requires an ID generated by the user. You pass the ID to the TELParkCall function (page 4-45) to park the call, and to the TELRetrieveParkedCall function (page 4-46) to retrieve the call.

rejectable

If this bit is set, this incoming call can be rejected. (Use the TELRejectCall function (page 4-31) to reject the call.)

deflectable

If this bit is set, this incoming call can be deflected. (Use the TELDeflectCall function (page 4-32) to deflect the call.)

acceptable

If this bit is set, this incoming call can be accepted. (Use the TELAcceptCall function (page 4-29) to accept the call.)

voiceDetected

If this bit is set, for an incoming call, a voice signal was detected. This bit gets set if you call the TELCAVoiceDetect function (page 4-50) and a voice signal is detected. Once set, it is never cleared.

callAnswdTSRings

If this bit is set, this incoming call was auto-answered with the Call Saver feature enabled. (The Call Saver feature is the ability to auto-answer a call on a greater or lesser number of rings, depending on certain conditions, such as the existence of voice mail messages. The call saver ring count is a tool-specific number; the mechanism to set the call saver ring count is also tool specific. For example, some tools may use a control panel to elicit a number from the user.)

progressHasDuration

If this bit is set, call progress messages for this call appearance contain a duration value, expressed in milliseconds, in the mType parameter to the call appearance message handler.